APPENDIX A 



/* $Header: /cvs/ReaUava/src/rjavar/java/com/softcom/realjava/plugins/RealTOC java v ] 17 

1999/05/20 20:47:42 aw Exp $ */ 

// Copyright (c) 1998 SoftCom, Inc. All Rights Reserved. 

package com.softcom.realjava.plugins; 

import javax.swing. *; 

import javax.swing.tree. *; 

import java. awt.*; 

import java.awt.event.*; 

import java.io.IOException; 

import java.net. URL; 

import java.net.MalformedURLException; 

import org. xml. sax.*; 

import com.microstar.xml.SAXDriver; 

import com.softcom.realjava.*; 

import com.softcom.realjava.time.*; 

/** 

* Synchronized table of contents plugin. 

* Displays a table of contents (TOC) whose nodes are highlighted 

* in sync with the presentation. Clicking on a node seeks the 

* presentation to that nodes time. 

* <P> 

* < CODE >RealTOC< /CODE > understands a < CODE > URL < /CODE > param which 

* refers to an XML document specifying a hierarchical TOC. 

* <P> 

* Sample XML object element: 

* < P>< TABLE B0RDER=1XTRXTD> 

* <PRE> 

* <?xml version ="1.0"?> 

* <object 

* classid= "com.softcom.realjava.plugins.RealTOC" 

* archive = "plugin.ja^,sax.ja^,aelf^ed.jar ,, 

* width="250" height="235" 

* sync="1000 n 

* duration ="900000" 

* > 

* <param name =" URL" value = "toc.xml7> 

* </object> < /PRE > 

* </TD> </TR> < /TABLE > <P> 

* This is the < CODR> TOC < /CODE > XML DTD. 



* < CODE > BEGIN < /CODE > and < CODE > END < /CODE > are times specified 

* in the format documented in < CODE > TimeSpanRegistry .parseTimeO < /CODE > . 

* Both are optional, but if either is specified, then both must be specified. 

* <P> < TABLE BORDER=l > <TR> <TD> 

* <PRE> 

* «felt;! ELEMENT TOC (NODE+)> 

* <! ELEMENT NODE (TITLE, NODE*)> 

* <!ATTLIST NODE 

* BEGIN CDATA #IMPLIED 

* END CDATA #IMPLIED 

* > 

* <! ELEMENT TITLE (#PCDATA)></PRE> 

* </TDX/TR >< /TABLE ><P> 

* Sample < CODE > TOC < /CODE > XML document: 

* <P> <TABLE BORDER=l > <TR> <TD> 

* <PRE> 

* <?xml version ="1.0"?> 

* <TOC> 

* <NODE BEGIN = "0" END= "4.999 B > 

* <TITLE>Root node one</TITLE> 

* <NODE BEGIN="5 n END="9.999"> 

* <TITLE>Node one child</TITLE> 

* <NODE BEGIN ="10" END = B 14.999"> 

* <TITLE>Node one subchild l</TITLE> 

* </NODE> 

* <NODE> 

* <TiTLE>Node one subchild 2</TITLE> 

* </NODE> 

* </NODE> 

* </NODE> 
*</TOC></PRE> 

* </TD> </TR> < /TABLE > <P> 

* RealTOC uses the AElfred XML parser and the SAX XML API 

* See < A TARGET ="_top" 

HREF= n http://www.microstar.com/aelfred.html n > http://www.microstar.com/aelfred html 
/A> 

* for information on the AElfred XML parser. 

* See < A TARGET = " top" 

HREF= "http://www.microstar.com/sax.html" > http://www.microstar.com/sax.html < /A > 

* for information on the SAX API to XML parsers. 
*/ 

public class RealTOC extends JScrollPane implements Plugin { 

private static final String MESSAGE_CATALOG = 
"com. softcom. realjava.plugins . RealTOCMessages " ; 



private PluginContext m_pcContext; 
private JTree mJcTree; 

private TimeSpanRegistry mtsrRegistry = new TimeSpanRegistryO; 

private static final String DTD = "toc.dtd"; 

// Implements Plugin 
public Synchronized getSynchronizedO { 
return m tsrRegistry; 

// Implements Plugin 

public void startPlugin(PluginContext pc) { 
m_pcContext = pc; 

// Construct AElfred SAX driver 
Parser parser = new SAXDriverO; 

// Set parser to handle the XML document. 
parser.setDocumentHandler(newTOCParserO); 

String strURL = m_pcContext.getParameter("URL n ); 
try { 

if (strURL == null) 

throw new MalformedURLExceptionO; 
URL url = new URL(m_pcContext.getDocumentBaseO, strURL); 
InputSource is = new InputSource(url.openStreamO); 

// Pass URL to DTD 

is.setSystemId(getClass0.getResource(DTD).toStringO); 

// Parse the document 
parser.parse(is); 
} catch (MalformedURLException e) { 
Console. showConsoleO; 

System.err.println(MessageCatalog.getMessage(MESSAGE CATALOG, 
getClassO, "msg.inf.invalidURL", strURL)); 
} catch (IOException e) { 

Console . showConsoleO ; 

System.err.println(MessageCatalog.getMessage(MESSAGE CATALOG 
getClassO, "msg-mf-parse")); 

e.printStackTraceO; 
} catch (SAXException e) { 
Console . showConsoleO ; 

System.err.println(MessageCatalog.getMessage(MESSAGE CATALOG 
getClassO, n msg.inf.parse n )); 



Exception ee = e.getExceptionO; 
if (ee = = null) 

e.printStackTraceO; 

else 

ee.printStackTraceO; 



// Add the tree 

getViewportO-add(m JcTree, BorderLayout. CENTER); 

// Implements Plugin 
public void destroyPluginO { 

// Object registered with event registry for each TOC event. 
// This object is also set as the TreeNode userObject 
private class TOCEvent implements TimeSpanListener { 

// Text to display in tree node 

private String mstrText; 

// -1 if no seek time specified 
private int mnTime = -1; 

// Path to node this event is associated with 
private TreePath mtpPath; 

public TOCEvent(DefaultMutableTreeNode to) { 
mtpPath = new TreePath(to.getPathQ); 



// Set text to display in tree node 
void setText(String strText) { 
mstrText = strText; 



// Set time to seek media to tree node selected 
public void setTime(int nTime) { 
mnTime = nTime; 



// Return seek time 
public int getTimeO { 
return m nTime; 

} 



// Event time reached, highlight tree node 

// Implements TimeSpanListener 

public void beginTimeSpan(TimeSpan ts) { 

// Select this tree node. This will make it visible too. 

mJcTree.addSelecnonPam(m_tpPath); 

// Implements TimeSpanListener 
public void endTimeSpan(TimeSpan ts) { 

// Deselect this tree node. 

mJcTree.removeSelectionPam(m_tpPath); 

// This is used by JTree to draw the node 
public String toStringO { 
return m strText; 

} 

}; 

private class TOCParser extends HandlerBase { 
//Root of tree 

private DefaultMutableTreeNode m tnRoot; 
// Current parent node 

private DefaultMutableTreeNode m tnParent; 
// Current child node 

private DefaultMutableTreeNode mmCurrent; 
// Title text accumulator 

private StringBuffer m_sbText = new StringBufferO; 
private boolean m bAccumulateText = false; 

// Overrides HandlerBase 

public void startElement(String strName, AttributeList attrs) throws SAXExcepti< 

if (strName.equalsCTOC'*)) { 

// Create hidden root of tree 
^ mtnRoot = mmCurrent = new DefaultMutableTreeNodeO; 

else if (strNamcequalsCNODE")) { 
mtnParent = mmCurrent; 

// Create a new node 

m mCurrent = new DefaultMutableTreeNodeO; 

// Add node as a child of the current node 
mtnParent. add(mmCurrent); 



// Create event for node 

TOCEvent te = new TOCEvent(m_tnCurrent); 

m_tnCurrent. setUserObject(te) ; 

// Set time on event if specified 

String strBegin = attrs.getValue("BEGIN"); 

if (strBegin != null) { 

String strEnd = attrs.getValue("END"); 

if (strEnd = = null) 
throw new 

SAXException(MessageCatalog.getMessage(MESSAGE_CATALOG, getClassO 
"^lsg.ex.missingTime ,, )); ' 

try { 

int nBeginTime = TimeSpanRegistry.parseTime(strBegin); 

int nEndTime = TimeSpanRegistry.parseTime(strEnd); 

// Set seek time in event 

te.setTime(nBeginTime); 

// Register event with the TOC timespan registry 

„ jrT ,. vx m_tsrRegistry.addTimeSpan(new TimeSpan(te, nBeginTime, 

nEndTime)); 

} catch (NumberFormatException e) { 
throw new 

SAXException(MessageCatalog.getMessage(MESSAGE CATALOG, getClassO 
"msg.ex.invalidTime"), e); 

} 

} 

} 

else if (strName.equalsfTITLE")) { 
// Reset String Buffer for new title 
m_sbText.setLength(0); 
mbAccumulateText = true; 

} 

// Invalid element 
else 

throw new 

SAXException(MessageCatalog.getMessage(MESSAGE_CATALOG, getClassO 
"msg.ex.invaUdElement", strName)); 

// Overrides HandlerBase 

public void endElement(String strName) throws SAXException { 
if (strName.equals("TOC n )) { 

// Finished building tree. Setup JTree with model. 
// Create the tree with the constructed nodes 
m J cTree = new JTree(m_tnRoot); 



mJcTree.setRootVisible(false); 

m JcTree.setShowsRootHandles(true); 



// Allow multiple selection so we can support overlapping timespans 

mJcTree.getSelectionModel0.setSelectionMode(TreeSelectionModel.DISCONTIGUOUS TR 
EE_SELECTION); 

// When a tree node is clicked (regardless of whether it was selected), 
// seek the video to the TOCEvent time registered with the node 
m JcTree.addMouseListener(new MouseAdapterO { 

// XXX mouseClicked is unreliable - it is not always called (bueid 
4224704) ' 

//public void mouseClicked(MouseEvent e) { 
public void mouseReleased(MouseEvent e) { 

// Only handle single clicks 

if (e.getClickCountO !- 1) 
return; 

// Get the path and node clicked on 

TreePathpath = m JcTree.getPathForLocationfe.getXO, 

e.getYO); 

if (path != null){ 

// Get the event registered with this node 
TOCEvent te = 

(TOCEvent)((DefaultMutableTreeNode)path.getLastPathComponentO).getUserObjectO; 

if (te ! = null && te.getTimeO > = 0) { 
// Seek the video 

m_pcContext.seekPlayer(te.getTimeO); 

} } 

} 

}); 

} 

else if (strName.equals("NODE")) { 
// Back up a level 

mtnCurrent = (DefaultMutableTreeNode)m_tnCurrent.getParentO; 

else if (strName.equals( n TITLE n )) { 
// Give title to current node 

(aOCEvent)m_toCuirent.getUserObjectO).setText(m_sbText.toStringO); 

m_bAccumulateText = false; 

} 

} 

// Overrides HandlerBase 

public void characters(char chD, int nStart, int nLength) throws SAXException { 



if (m_bAccumulateText) 

m_sbText.append(ch, nStart, nLength); 

}; 



// XXX debugging 

public static void main(String argsD) { 
Frame frm = new Frame 0; 
frm.setLayout(new BorderLayoutO); 
RealTOC rt = new RealTOCO; 
rt.startPlugin(new PluginContextO { 
public URL getCodeBaseO { 
try{ 

return new 

URL("file:S:/projects/realjava/src/rjavar/plugclasses/ n ); 

} catch (MalformedURLException e) { 
return null; 

} 

} 

public String getParameter(String strParam) { 
return "toc.xml"; 

} 

public int getDurationO { 
return 0; 

} 

public void seekPlayer(int nTime) { 
} 

public void showDocSnent(URL url, String" strTarget) { 

}); } 

frm.add(rt, BorderLayout. CENTER); 
frm.setSize(300, 300); 
frm.setVisible(true); 



